home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat1 / scsiadminswap.z / scsiadminswap
Encoding:
Text File  |  2002-10-03  |  9.5 KB  |  265 lines
  1.  
  2.  
  3.  
  4. ssssccccssssiiiiaaaaddddmmmmiiiinnnnsssswwwwaaaapppp((((1111MMMM))))                                            ssssccccssssiiiiaaaaddddmmmmiiiinnnnsssswwwwaaaapppp((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      scsiadminswap - perform a live plug or unplug of a scsi device
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ssssccccssssiiiiaaaaddddmmmmiiiinnnnsssswwwwaaaapppp [ options ]
  13.  
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _s_c_s_i_a_d_m_i_n_s_w_a_p allows a user to live plug or unplug a scsi device assuming
  17.      it is not a primary resource (such as the system disk).  There are three
  18.      required options.  These indicate whether to perform a plug or an unplug
  19.      and provide a bus and device number.  An additional argument can be used
  20.      to change the default timeout value.  To execute _s_c_s_i_a_d_m_i_n_s_w_a_p, a user
  21.      must have root status.
  22.  
  23.      There are many different ways that a disk may be accessed.  While this
  24.      man page outlines and gives examples of the more common ones, if there is
  25.      any question the user should check the man pages for umount, mount, or
  26.      the Insight book "SGI Admin: IRIX Admin: Disks and Filesystems."  If the
  27.      disk is being used as part of an xlv volume more information can be found
  28.      via man on xlv_mgr, xlv_make, xlv_assemble, xlv_shutdown, or chapter 4 of
  29.      the above Insight book.
  30.  
  31.      UUUUnnnnpppplllluuuuggggggggiiiinnnngggg aaaa ddddiiiisssskkkk::::
  32.  
  33.      Before executing the _s_c_s_i_a_d_m_i_n_s_w_a_p unplug, all the file systems of the
  34.      disk in question must be unmounted (see _u_m_o_u_n_t(_1_M)), detached (if a
  35.      mirrored xlv volume) see xlv_mgr(1M).  To do so it may be necessary to
  36.      use _f_u_s_e_r(_1_M) to kill any processes using the file systems.  If a file
  37.      system on the disk is an unmirrored xlv volume it is also necessary to
  38.      execute an _x_l_v__s_h_u_t_d_o_w_n(_1_M) after the umount.  For each file system on
  39.      the disk one of the following steps should be taken.  After one of the
  40.      below cases (or other as needed) has been performed for all file systems
  41.      on the disk then run scsiadminswap -u -b # -d #.
  42.  
  43.      Case 1: the file system is not an xlv volume
  44.      1) Unmount the file system
  45.        a) Hint: fuser finds and kills processes using a file system.
  46.  
  47.      Case 2: the file system is an unmirrored xlv volume:
  48.      1) Unmount the file system
  49.        a) Hint: fuser finds and kills processes using a file system.
  50.      2) Perform an xlv_shutdown.
  51.  
  52.      Case 3: the file system is a mirrored xlv volume:
  53.      1) Run xlv_mgr and perform a detach of the plex using the disk.
  54.  
  55.      PPPPlllluuuuggggggggiiiinnnngggg iiiinnnn aaaa ddddiiiisssskkkk::::
  56.  
  57.      First run scsiadminswap -p -b # -d #.  Now the file system may need to be
  58.      mounted (see _m_o_u_n_t(_1_M)) or made part of an xlv volume.  If the disk is
  59.      going to be part of a mirrored volume and already has vlx header
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ssssccccssssiiiiaaaaddddmmmmiiiinnnnsssswwwwaaaapppp((((1111MMMM))))                                            ssssccccssssiiiiaaaaddddmmmmiiiinnnnsssswwwwaaaapppp((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      information, an xlv_assemble(1M) should be performed.  If the disk is
  75.      going to be part of a mirrored volume but does not have xlv header
  76.      information an xlv_make(1M) should be performed before the
  77.      xlv_assemble(1M).  If the disk had old (from a different volume) xlv
  78.      information then perform a delete using xlv_mgr(1M) before either of the
  79.      above steps).  Depending on what needs to be done one of the following
  80.      cases may apply.
  81.  
  82.      Case 1: the file system is not an xlv volume
  83.      1) Mount the file system
  84.  
  85.      Case 2: the file system contains no prior xlv information
  86.              and will be an unmirrored xlv volume:
  87.      1) Perform an xlv_make
  88.      2) Run xlv_mgr and perform an attach.
  89.      3) Mount the file system
  90.  
  91.      Case 3: the file system is on a disk without prior xlv
  92.      information and will be a mirrored xlv volume:
  93.      1) Mount the file system
  94.      2) Perform an xlv_assemble.
  95.  
  96.      Case 4 & 5: As 2 & 3, except the disk has old xlv_info:
  97.      1) Run xlv_mgr and perform a delete of the xlv label information
  98.      2) Go to Case 2 or 3
  99.  
  100.      The above cases for plug and unplug only cover the common xlv situations.
  101.      More information regarding xlv volumes can be found in the "SGI Admin:
  102.      IRIX Admin: Disks and Filesystems" Insight Book.  Also see the .B
  103.      Examples section at the end of the man page for a sample session.
  104.  
  105.  
  106.      The required options are:
  107.  
  108.      ----uuuu oooorrrr ----pppp     Indicates whether operation is an (u)nplug or a (p)lug.  If
  109.                   both are specified, it will be report as an error.
  110.  
  111.      ----bbbb bbbbuuuussss       Specifies the scsi bus for the device.
  112.  
  113.      ----dddd ddddeeeevvvviiiicccceeee nnnnuuuummmmbbbbeeeerrrr
  114.                   Specifies the slot number for the drive to be removed or
  115.                   inserted.
  116.  
  117.      Additional options:
  118.  
  119.      ----tttt sssseeeeccccssss      Specifies the number of seconds the command will wait while
  120.                   the drive is inserted or removed.  This default value is 300
  121.                   (5 minutes).  This is the amount of time the command will
  122.                   wait before automatically continuing with the sequence.  In
  123.                   general the command continues when the user hits enter after
  124.                   having inserted or removed the drive.
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ssssccccssssiiiiaaaaddddmmmmiiiinnnnsssswwwwaaaapppp((((1111MMMM))))                                            ssssccccssssiiiiaaaaddddmmmmiiiinnnnsssswwwwaaaapppp((((1111MMMM))))
  137.  
  138.  
  139.  
  140.      ----ffff           Force the command to occur even if it discovers there are
  141.                   still mounted file systems, or file systems in use.  This is
  142.                   very dangerous.
  143.  
  144.  
  145. EEEExxxxaaaammmmpppplllleeeessss
  146.      The following sequence of commands could be used to swap a disk in slot 2
  147.      with partition 7 mounted as /x
  148.  
  149.      umount /x
  150.      scsiadminswap -u -b 0 -d 2
  151.      scsiadminswap -p -b 0 -d 2
  152.      mount -t xfs /dev/dsk/dks0d2s7 /x
  153.  
  154.      The following sequence of commands could be used to swap a disk
  155.      containing old xlv information into slot 2 with partition 7 mounted as a
  156.      unmirrored xlv volume named /lv1.
  157.  
  158.      umount /lv1
  159.      xlv_shutdown -n sample_vol
  160.      scsiadminswap -p -u -b 0 -d 2
  161.      xlv_mgr -xc "delete label /dev/rdsk/dks0d2vh" (delete old label information)
  162.      xlv_make (see xlv_make man page for examples)
  163.      xlv_mgr (perform attach)
  164.      mount -t xfs /dev/dsk/dks0d2s7 /lv1
  165.  
  166.  
  167. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  168.      fuser(1M), mount(1M), umount(1M), xlv_assemble(1M), xlv_make(1M),
  169.      xlv_mgr(1M), xlv_shutdown(1M), fstab(4), mtab(4), scsiha(7M).
  170.  
  171.  
  172. WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS
  173.      Care should be take when using the _s_c_s_i_a_d_m_i_n_s_w_a_p command.  There are
  174.      periods when the scsi bus is in a sensitive state.  The command should
  175.      always be allowed to continue to completion.  Keep the amount of time it
  176.      takes to remove or insert the drive to a minimum.  The most sensitive
  177.      time occurs during the unplug operation while the command is waiting for
  178.      the drive to be removed.  During this period no other data can be written
  179.      to any device on the bus from which the drive is being removed.  If the
  180.      drive can not be removed or inserted in the requested time do NOT kill
  181.      the command half way through, let it finish and re-try again later.
  182.      Killing the command during execution will leave the scsi bus in a bad
  183.      state.  Also to help ensure command success and prevent the system from
  184.      failing, any file systems on the disk to be removed should not currently
  185.      be in use.
  186.  
  187.  
  188. NNNNOOOOTTTTEEEE
  189.      The Performance Co-Pilot (see _P_C_P(_1)) may be used to monitor SCSI
  190.      devices, however configuration changes by _s_c_s_i_a_d_m_i_n_s_w_a_p may not be
  191.      asynchronously detected.  If SCSI devices are being monitored,
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ssssccccssssiiiiaaaaddddmmmmiiiinnnnsssswwwwaaaapppp((((1111MMMM))))                                            ssssccccssssiiiiaaaaddddmmmmiiiinnnnsssswwwwaaaapppp((((1111MMMM))))
  203.  
  204.  
  205.  
  206.      _l_i_b_i_r_i_x_p_m_d_a(_5) may be notified and forced to reset using the command:
  207.  
  208.                > pmstore irix.xbow.switch 1
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.